home *** CD-ROM | disk | FTP | other *** search
/ Software of the Month Club 1999 November / SOTMC_Nov1999-Ultimate.iso / mac / REALbasic ƒ / Examples / Applications / Xtractor 1.1 ƒ / READ ME! next >
Encoding:
Text File  |  1998-07-15  |  7.1 KB  |  130 lines  |  [TEXT/ttxt]

  1. Xtractor
  2. by Rick Downs and Serge Palluel
  3. published by red designs
  4.  
  5. Xtractor is a simple utility which makes it easy to extract XCMD,XFCN, CURS, or PICT resources from any file. Xtractor takes those resources, and creates a folder of individual ResEdit files, each containing one of the resources. These are then suitable for you to drop into a REALbasic project.
  6.  
  7. USING XTRACTOR
  8. Xtractor is easy to use. Simply open a file, using the Open╔ command from the File menu or by clicking on the Open button in the toolbar. When the file is opened, a window will appear which shows you how many XCMDs,XFCNs, CURSs, and PICTs are in that file. 
  9.  
  10. You can extract just one type of resource, or all by selecting the appropriate choice, again from either the File menu or the toolbar. You will be presented with a file save dialog which lets you decide where the extracted resource files will be saved. As the externals are extracted, you will see a progress bar showing how far along the extraction process is at that point.
  11.  
  12. TERMS OF USE - LICENSE
  13. Xtractor is free software. This license is designed not to restrict your
  14. freedom except insofar as is necessary to ensure that the program remains free
  15. for all.
  16.  
  17. Xtractor is copyright ⌐ red designs, 1998.
  18.  
  19. This license describes the conditions under which you may use, modify and
  20. distribute version 1.1 of Xtractor ("the program"). Except where stated,
  21. the conditions of this license apply equally to the source code for the
  22. program, as well as to any compiled version. If you are unable or unwilling
  23. to accept these conditions in full, then, notwithstanding the conditions in
  24. the remainder of this license, you may not use, modify or distribute the
  25. program at all. 
  26.  
  27.  
  28. 1) Any action which is illegal under international or local law is forbidden
  29.    by this license. Any such action is the sole responsibility of the person
  30.    committing the action.
  31.  
  32. 2) The program may be used free of charge by any person or organization to
  33.    whom it is made available, provided that that person accepts the conditions
  34.    of this license.
  35.  
  36. 3) The program may be copied and distributed by any person or organization in
  37.    any way whatsoever, provided that any distribution is accompanied by a copy
  38.    of the Readme file pertaining to the program. You may not charge for
  39.    distributing the program without first informing the person to whom it is
  40.    distributed that Xtractor is free software. Furthermore, you may not charge
  41.    for distributing a modified version of the program unless the source code
  42.    for the modified version, or a list of differences between the modified
  43.    version and the original version, is publicly and freely available in
  44.    machine readable form. 
  45.   
  46. 4) You may make a reasonable charge for either of the following services,
  47.    provided in each case that the third party is made aware that Xtractor is free
  48.    software and that the charge is therefore for your labor, expertise and
  49.    costs.
  50.    i) Installing the program on a computer on behalf of a third party;
  51.   ii) Running the program and providing output from it to a third party.
  52.    You may not charge for these services in connection with a modified version
  53.    of the program unless the source code for the modified version, or a list
  54.    of differences between the modified version and the original version, is
  55.    publicly and freely available in machine readable form.
  56.  
  57. 5) You may modify the program in any way you wish provided that all of the
  58.    following conditions are met:
  59.    i) Any modification in the source code is clearly marked as such;
  60.   ii) No modification is made to the Readme file; i.e. any documentation needed 
  61.             on your changes must therefore be made in a separate file.
  62.  iii) All of the conditions of this license, and no other conditions, apply to
  63.       your modified version.
  64.    You may claim copyright for the parts of the program you have written. 
  65.       You are encouraged to submit your changes to red designs for inclusion in 
  66.         subsequent versions of Xtractor.
  67.  
  68. 6) No warranty of any sort, expressed or implied, is provided in connection
  69.    with the program, including, but not limited to, implied warranties of
  70.    merchantibility or fitness for a particular purpose. Any cost, loss or
  71.    damage of any sort incurred owing to the malfunction or misuse of the
  72.    program or the inaccuracy of the documentation or connected with the program
  73.    in any other way whatsoever is the responsibility of the person who incurred
  74.    the cost, loss or damage. By using this program you give up any right to
  75.    seek any damages against the author(s) in connection with this program. 
  76.  
  77. 7) red designs reserve the right to make exceptions to any of these
  78.    conditions, or alter these conditions, at any time. However, you may always
  79.    use these conditions instead of any altered version if you prefer.
  80.  
  81. CONTACTING red designs
  82. Visit our website at http://www.macconnect.com/~red/ 
  83. or 
  84. e-mail to red@macconnect.com
  85. _________________________________________________________________
  86. Revision History
  87.  
  88. V1.0 - 5/22/98
  89.  - Initial release by Rick Downs
  90.  - Xtract XCMDs or XFCNs, or both from a file
  91.  - Toolbar or menu control
  92.  
  93. V1.1 - 7/5/98
  94.  - Additions by Serge Palluel:
  95.      - CURS (Cursors) can now be extracted too ...
  96.     - Xtractor now uses FullSFPack XFCN to replace standard File Dialogs : It allows to print a message in the dialog to tell the user what he has to choose ...
  97.     - Closing the toolbar now quit the application ...
  98.     - Some checking added for situations where no resource or no resource XCMD (or XFCN or CURS) where found ...
  99.     - Cosmetics changes where made :
  100.             . Cursor changes to a finger when an active button is under the mouse cursor
  101.             . Toolbar buttons where changed ...
  102.             . Xtracting buttons changes to disabled when no file has been opened or no when no Resource object is available ...
  103.             . Toolbar window can no more be Resized ...
  104.             . Xtractor application now has a custom icon ...
  105.     - Xtractor can now extract resources from applications ...
  106.      In an Hypercard stack every resource component has a name but some applications have none 
  107.      You got a "Nil ... Exception" in Xtractor ...
  108.      Now Xtractor gives a name like "XCMDNoNameN" when you extract Nth XCMD.
  109.      Before using those "NoName"d in RB just change the file name in the finder ...
  110.      
  111. - Additions by Rick Downs
  112.   - PICT resources now can be extracted and saved as PICT files
  113.     - Drag and drop a file on Xtractor and it will launch and open the file (only works for one file) - if you drop more than one, you get a messagebox warning of this
  114.     - New icon
  115.     - Animated toolbar, new design
  116.   - Code is now commented!
  117.  
  118. _________________________________________________________________
  119. Future Development
  120.  
  121. Xtractor will not be developed further by red designs. Serge Palluel has been doing some further enhancements to the user interface as an exercise in learning REALbasic. You can see what he's been doing at his website, at  
  122.  
  123. http://members.xoom.com/pserge/realbasic.htm.
  124.  
  125. A new program, called Resource Extractor, is under development. This program will function much like Xtractor, in that will allow you to extract resources from files. But its operation will be entirely drag-and-drop, much like Stuffit Expander. Check the red designs website for this future development!
  126.  
  127.  
  128.  
  129.  
  130.